home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / spiele / workbench spiele / x-wins / docs / english / x-wins.doc < prev    next >
Text File  |  1996-01-10  |  13KB  |  606 lines
  1.  
  2.                                      X-Wins
  3.  
  4.                                    Version 2.4
  5.                           (c) 1995/96 Mario Dannebauer
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  Introdution: What is X-Wins?
  13.  
  14.  
  15.  X-Wins is s strategy game like "4-in-a-row".
  16.  
  17.  The goal of this game is to  become  4  (or  more) Stones in a row (verticaly, 
  18.  horizontaly  or  digonaly). This happens while the opponents sets their stones 
  19.  alternate in a x*y-sizing gamefield. You can set a stone by clicking in a free 
  20.  field of your choise in the gamefield.
  21.  
  22.  If the field(s) under your clicked field  are  free  too,  your stone will fall
  23.  down, because the stones in one vertical row are like a tower.
  24.  
  25.  For more information read the chapter Gameplay of this documantation.
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  Disclaimer
  33.  
  34.  
  35.  THERE IS NO  WARRANTY  FOR  THE  PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE
  36.  LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDER AND/OR OTHER
  37.  PARTIES PROVIDE  THE  PROGRAM "AS IS" WITHOUT WARRANTY  OF   ANY KIND,   EITHER
  38.  EXPRESS  OR  IMPLIED, INCLUDING, BUT NOT LIMITED TO,  THE IMPLIED WARRANTIES OF
  39.  MERCHANTABILITY AND FITNESS FOR A PARTICULAR  PURPOSE.  THE ENTIRE RISK  AS  TO
  40.  THE QUALITY  AND  PERFORMANCE OF THE   PROGRAM  IS WITH YOU. SHOULD THE PROGRAM
  41.  PROVE DEFECTIVE,  YOU   ASSUME THE COST OF ALL NECESSARY   SERVICING, REPAIR OR
  42.  CORRECTION.
  43.  
  44.  IN NO EVENT UNLESS REQUIRED BY APPLICABLE  LAW OR AGREED TO IN WRITING WILL ANY
  45.  COPYRIGHT  HOLDER,  OR  ANY  OTHER PARTY  WHO  MAY REDISTRIBUTE  THE PROGRAM AS
  46.  PERMITTED   ABOVE,   BE   LIABLE   TO YOU FOR DAMAGES,   INCLUDING ANY GENERAL,
  47.  SPECIAL, INCIDENTAL   OR CONSEQUENTIAL   DAMAGES ARISING   OUT   OF  THE USE OR
  48.  INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA 
  49.  BEING RENDERED INACCURATE OR LOSSES  SUSTAINED  BY YOU  OR  THIRD  PARTIES OR A
  50.  FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER
  51.  OR   OTHER PARTY   HAS   BEEN   ADVISED   OF  THE POSSIBILITY OF SUCH DAMAGES.
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  Copyright
  59.  
  60.  
  61.  
  62.                     X-Wins is copyrighted by Mario Dannebauer 1995.
  63.  
  64.  
  65.                               X-Wins is Giftware !
  66.  
  67.  This means you are absolutely NOT forced to  send me money to go on using  this
  68.  program.  But,  if you really like this software or find it really useful, then
  69.  feel free  to  send  me  some  money  or other stuff like a postcard, a letter,
  70.  software, hardware, etc...
  71.  
  72.  If you find some bugs in this program or if you  have any   suggestions,  ideas
  73.  etc. please contact the author.
  74.  
  75.  
  76.  
  77.  For building this program the following products were used:
  78.  
  79.  o A4000/40 (OS 3.0) with 80MB HD and 8MB fast ram
  80.  
  81.  o SAS/C V6.51
  82.    Copyright (c) 1992-1994 SAS Institute, Inc, Cary, NC
  83.  
  84.  o "Magic User Interface" V2.1
  85.    Copyright (c) 1993/94 by Stephan Stuntz
  86.  
  87.  o XDME Version 1.54 by Aaron Digulla
  88.    [DME (C)Copyright 1987-91 by  Matthew Dillon]
  89.  
  90.  
  91.  
  92.   Trademarks:
  93.  
  94.   Amiga, AmigaDOS and Workbench are registered trademarks of Amiga Technologies GmbH.
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  Distribution
  102.  
  103.  
  104.  X-Wins has to be distributed as  it  comes.  The package must not be changed in
  105.  any  way.  The  only exception is to pack the whole package in an archieve. For
  106.  any other distribution form you must have a written permission by the author.
  107.  
  108.  There must not be any profit selling this package!
  109.  
  110.  When including this program in  a public-domain-serie please send me a message.
  111.  May be  there's  already a new version of this program so you don't include old
  112.  stuff.
  113.  
  114.  If you wish to supply this programm as part of a CD-ROM compilation, you need a
  115.  written permission by the author.
  116.  
  117.  Explicit permission is granted  to distribute this   programm   on   any CD-ROM
  118.  produced by Fred Fish / Amiga Library Services, and on any officially supported
  119.  Aminet  compilation CD-ROM.
  120.  
  121.  Comercial distribution of this program is only allowed with written  permission
  122.  by the author.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  Requirements
  130.  
  131.  
  132.  To use this program you need:
  133.  
  134.  o An Amiga with OS 2.0 or higher.
  135.  
  136.  o The "Magic User Interface" (short: MUI) Version 2.1 or higher.
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  How to install?
  144.  
  145.  
  146.  To install X-Wins on your Amiga just copy the the file "X-Wins" - or the  whole
  147.  drawer - where you want.
  148.  
  149.  To make online-help avaiable, just copy the "*.guide"-file, wich corresponds to
  150.  your  language,  from  the  "Docs"-drawer  to  the  same drawer of the Programm
  151.  "X-Wins".
  152.  
  153.  Do you want to use the program in your local language but you have  not  copied
  154.  the  hole  drawer,  just  copy the  "*.catalog"-file  from  the catalogs-drawer
  155.  included  in  this  package  to  the  LOCALE:Catalogs directory.  The  build-in
  156.  language is english.
  157.  
  158.  If you've written a catalog for another language, please send it to me.
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  How to play the Game?
  167.  
  168.  
  169.  X-Wins is s strategy game like "4-in-a-row".
  170.  
  171.  When you start the program a window and a requester appears. After closing the 
  172.  requester by clicking the "OK"-Button you see the main-window.
  173.  
  174.  Now you can change the prefenrences or begin to play.
  175.  
  176.  
  177.  To make your turn (set a stone) just click in a free field  of  the  gamefield.
  178.  Since you see the gamefield from the side-view and not from the top, your stone
  179.  will fall down if possible. That means you build a tower in each coloumn.
  180.  
  181.  After you have made your turn it's your opponents turn.
  182.  
  183.  You have won the game when you have 4  (or  more)  stones in a row. That means 
  184.  verticaly, horizontaly or digonaly. If neither you nor your opponent can build 
  185.  that row, nobody wins.
  186.  
  187.  
  188.  And now have fun!
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  The Main-Window
  196.  
  197.  
  198.  At the top of this window you will  see  a  status-line. This line informs you 
  199.  about the actual player and later about the winner of the game if exists.
  200.  
  201.  
  202.  
  203.  There are five buttons under the status-line:
  204.  
  205.  "New Game"  "Back"  "Help"  "Swap"  "Preferences..."
  206.  
  207.  
  208.  
  209.  Under these buttons you can see the gamefield which looks  like  a  grid.  Each
  210.  field of this grid are a field where you can place a stone in the course of the
  211.  game.
  212.  
  213.  To make your turn (set a stone) just click  in  a  free field of the gamefield.
  214.  Since you  see  the  gamefield  from  the  side-view and not from the top, your
  215.  stone  will  fall down  if  possible.  That  means  you  build  a tower in each
  216.  coloumn.
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  New Game
  224.  
  225.  
  226.  Clicking at this button will clear the game field and begin a new game.
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  Back
  234.  
  235.  
  236.  Clicking at this button will take back your latest turn and then it's your turn
  237.  again.  If  you  are playing against the computer the last turn of the computer
  238.  will take back too, so it's your turn again.
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  Help
  246.  
  247.  
  248.  Clicking at this button will change in the help-mode. In this mode the computer
  249.  will search for the best move he find for you.
  250.  
  251.  
  252.  The result is ...
  253.  
  254.    ... a blinking field. That means this is the best turn from the view  of  the
  255.    computer. (Not really always the best move you can do.)
  256.  
  257.    ... a requester wich informs you that you have no chanche to win  this  game.
  258.    That  means that your next turn doesn't matter, because you will always loose
  259.    later. (If you take back your last turn you will maybe change the situation.)
  260.  
  261.    ... a requester wich informs you that you will win this game if you see  your
  262.    chanche now. After closing this requester you will see a blinking field. That
  263.    means this is the best turn from the view of the computer.
  264.    (You will certainly win this game some  time  if  conform  to  the  move  the
  265.    computer found.)
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  Swap sides
  273.  
  274.  
  275.  Clicking this gadget you can swap the sides. That means, player 1 and player  2
  276.  are swapping the mode, the name and the colour of stones.
  277.  
  278.  After a swapping the sides, it's (logically) your opponents move!
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  Preferences
  286.  
  287.  
  288.  After clicking at this button you will see the prefenrences-window.
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  Preferences-Window
  296.  
  297.  
  298.  In  this  window  you  can  set   some preferences like width and height if the
  299.  gamefield, the beginner of the game etc.
  300.  
  301.  Contents of this window:
  302.  
  303.  String-gadgets: Player 1               Cycle-gadgets: Mode player 1
  304.                  Player 2                              Mode player 2
  305.  
  306.  Cycle-gadget:   Beginner               Slider:        Deep of searching
  307.  
  308.  Sliders:        Fields horizontally
  309.                  Fields vertically
  310.                  Stones in a row
  311.  
  312.  Checkmarks:     Messages
  313.                 (Begin a new game)
  314.  
  315.  
  316.  Buttons:        Save Use Cancel
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  Names of players
  324.  
  325.  
  326.  Here you can input your and your opponents name.
  327.  
  328.  If a player is computer navigated, the stringgadget for the name of this player
  329.  is ghosted.
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  Player mode
  337.  
  338.  
  339.  With this two cycle-gadgets you can set for each player, if he's a human player
  340.  or computer navigated.
  341.  
  342.  If a player is computer navigated, the stringgadget for the name of this player
  343.  is ghosted.
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  Who begins?
  351.  
  352.  
  353.  Here you can set the beginner of the next game.
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  Deep of searching
  361.  
  362.  
  363.  With  this  slider  you  can  set  how  many  moves  the  computer-opponent  is
  364.  calculating when he is searching for his move.
  365.  
  366.  This slider also sets the depht  of  the  search  when  you  are  clicking  the
  367.  Help-Gadget in the mainwindow.
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  Fields horizontally
  375.  
  376.  
  377.  Here you can change the number of rows of the gamefield.
  378.  
  379.  (This slider is ghosted, until you begin a new game, respectively all fields of
  380.   the gamefield must be free.)
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  Fields vertically
  388.  
  389.  
  390.  Here you can change the number of lines of the gamefield.
  391.  
  392.  (This slider is ghosted, until you begin a new game, respectively all fields of
  393.   the gamefield must be free.)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  Stones in a row
  401.  
  402.  
  403.  With this slider you can change the number of stones in a row needed to win the
  404.  game.
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  Messages
  412.  
  413.  
  414.  This checkmark lets you switch the messages on and off.
  415.  
  416.  Switching the messages on means that you'll see a  requester  with  a  message,
  417.  when  your  computer-opponent  think  that  you  can  not  win the actual game,
  418.  respectively that you will win the game when you see your chanche now.
  419.  
  420.  (This checkmark is ghosted, until one of the players is a humen player.)
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  Begin a new game
  428.  
  429.  
  430.  Since you can not change all the preferences during a game, this checkmark
  431.  exists.
  432.  
  433.  Marking that means that  you   want   to   begin   a new game and   all ghosted
  434.  gadgets will be now unghosted.
  435.  
  436.  (Only visible, when a game is in progress.)
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  Save/Use/Cancel
  444.  
  445.  
  446.  Here you can save and use, use without saving or chancel your changes.
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  History
  454.  
  455.  
  456.  
  457.  Revision V2.4
  458.  -------------
  459.  created on 10.01.96 by Mario Dannebauer
  460.  
  461.   - updated text files
  462.   - bug fixed in catalog-file (thanks Frank!)
  463.   - decreased code size
  464.  
  465.   --- Public release ---
  466.  
  467.  
  468.  
  469.  Revision V2.3
  470.  -------------
  471.  created on 11.12.95 by Mario Dannebauer
  472.  
  473.   - bug fixed: switch messages on/off works now correctly
  474.   - added new button: swap (sides)
  475.   - added new options: winner/looser begins, alternate beginner
  476.   - added online-help
  477.   - added keyboard control for all windows
  478.   - enabled beginner-options during game (don't know why disabled this before)
  479.  
  480.   --- Public release ---
  481.  
  482.  
  483.  
  484.  Revision V2.1
  485.  -------------
  486.  created on 15.11.95 by Mario Dannebauer
  487.  
  488.   - italian language catalog added
  489.  
  490.   --- Public release ---
  491.  
  492.  
  493.  
  494.  
  495.  Revision V2.0
  496.  -------------
  497.  created on 25.10.95 by Mario Dannebauer
  498.  
  499.   - documantation written
  500.   - icon created
  501.   - add variable number of rows to win
  502.   - bumped to version 2
  503.  
  504.   --- First public release ---
  505.  
  506.  
  507.  
  508.  Revision V1.9
  509.  -------------
  510.  created on 21.02.95 by Mario Dannebauer
  511.  
  512.   - internal game structure rewritten
  513.   - add variable dimensions of gamefield
  514.  
  515.   --- Private release ---
  516.  
  517.  
  518.  
  519.  Revision V1.6
  520.  -------------
  521.  created on 13.7.94 by Mario Dannebauer
  522.  
  523.   - add preferences window
  524.  
  525.   --- Private release ---
  526.  
  527.  
  528.  
  529.  Revision V1.5
  530.  -------------
  531.  created on 26.5.94 by Mario Dannebauer
  532.  
  533.   - MUI-Version
  534.  
  535.   --- Private release ---
  536.  
  537.  
  538.  
  539.  Revision V1.0
  540.  -------------
  541.  created on 12.03.93 by Mario Dannebauer
  542.  
  543.   --- Initial release ---
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  Future
  550.  
  551.  
  552.  I don't plan further versions of this program next time, but if you have some 
  553. ideas or suggestions then contact me.
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  Credits
  561.  
  562.  
  563.  Thanks must go to:
  564.  
  565.  o Piergiorgio Ghezzo for the translation of the language catalog to italian.
  566.  
  567.  o Stephan Stuntz for his fantastic "Magic User Interface"
  568.  
  569.  o SAS Institute for their great C-Compiler
  570.  
  571.  o Aaron Digulla and Matthew Dillon for their XDme/Dme
  572.  
  573.  o Amiga Technologies GmbH and all the PD-programmers/-distributors, who keeps the
  574.    Amiga alife.
  575.  
  576.  o ...and anyone who send me something for this program or give me suggestions.
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  Author
  584.  
  585.  
  586.  
  587.                                Mario Dannebauer
  588.                                     O7 29
  589.                                 68161 Mannheim
  590.                                    Germany
  591.  
  592.                               phone: 0621/20390
  593.  
  594.  
  595.                          Or using e-mail (Internet) to:
  596.                         86308@novell1.rz.fht-mannheim.de
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.